@delorenj/mcp-server-trello 1.0.0 → 1.2.0

package/README.md

@@ -6,8 +6,59 @@
 
 A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello's API while handling rate limiting, type safety, and error handling automatically.
 
+## 🎉 New in v1.2.0: Complete Checklist Management Suite!
+
+**Comprehensive Checklist Tools are here!** 🚀 Now you can fully manage Trello checklists with 5 powerful new tools! Search, create, and track checklist items across your boards. Perfect for managing acceptance criteria, development tasks, and project milestones!
+
+### ✨ New Checklist Tools:
+- 📋 **`get_checklist_items`** - Retrieve all items from any checklist by name
+- ➕ **`add_checklist_item`** - Add new items to existing checklists  
+- 🔍 **`find_checklist_items_by_description`** - Search checklist items by text content
+- ✅ **`get_acceptance_criteria`** - Quick access to "Acceptance Criteria" checklists
+- 📊 **`get_checklist_by_name`** - Get complete checklist with completion percentage
+
+**Plus:** Modern MCP SDK architecture, enhanced type safety, and comprehensive documentation!
+
 ## Changelog
 
+### 1.2.0
+
+**🎊 Major Feature Release: Complete Checklist Management Suite**
+
+- **5 New Checklist Tools** for comprehensive checklist management:
+  - `get_checklist_items(name)` - Retrieve all items from a checklist by name
+  - `add_checklist_item(text, checkListName)` - Add new items to existing checklists
+  - `find_checklist_items_by_description(description)` - Search checklist items by text content
+  - `get_acceptance_criteria()` - Convenience method for "Acceptance Criteria" checklists
+  - `get_checklist_by_name(name)` - Get complete checklist with completion percentage
+- **Modern MCP SDK Architecture:** Refactored to use latest MCP TypeScript SDK patterns with `registerTool()` and Zod validation
+- **Enhanced Type Safety:** Full TypeScript support with proper type conversions between Trello API and MCP types
+- **New Data Types:** `CheckList` and `CheckListItem` interfaces for structured checklist data
+- **Comprehensive Documentation:** Added `CHECKLIST_TOOLS.md` with examples and best practices
+- **Improved Error Handling:** Consistent error responses with descriptive messages
+- **Runtime Validation:** Zod schemas for all tool inputs with automatic validation
+
+### 1.1.0
+
+**🎊 Major Feature Release: Complete Card Data Extraction**
+
+- Added powerful `get_card` tool for comprehensive single card data retrieval
+- **Enhanced Data Extraction:**
+  - ✅ **Checklists** - Full checklist support with items, completion states, member assignments, and due dates
+  - 📎 **Attachments** - Complete attachment data including images, previews, file metadata, and inline image detection
+  - 🏷️ **Labels** - Full label details (names and colors, not just IDs)
+  - 👥 **Members** - Card member assignments with full profile information
+  - 💬 **Comments** - Card activity and comment history
+  - 📊 **Badges** - Statistics including checklist progress, comment counts, and attachment counts
+  - 🎨 **Cover Images** - Card cover image support
+  - 📍 **Context** - Board and list information for complete context
+  - 🔧 **Custom Fields** - Support for board-specific custom fields
+- **Markdown Formatting:** New `includeMarkdown` parameter returns beautifully formatted, human-readable card data
+- **Inline Image Parsing:** Automatically detects and extracts images embedded in card descriptions
+- **Comprehensive API Integration:** Single API call fetches all card data efficiently using optimized query parameters
+- **Type Safety:** Added new TypeScript interfaces for all enhanced data structures
+- **Human Parity:** Achieves complete parity with Trello UI - see everything a human sees
+
 ### 1.0.0
 
 - Fixed MCP protocol compatibility by removing all console output that interfered with JSON-RPC communication
@@ -57,11 +108,13 @@ A Model Context Protocol (MCP) server that provides tools for interacting with T
 ## Features
 
 - **Full Trello Board Integration**: Interact with cards, lists, and board activities
+- **🆕 Complete Card Data Extraction**: Fetch all card details including checklists, attachments, labels, members, and comments
 - **Built-in Rate Limiting**: Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token)
 - **Type-Safe Implementation**: Written in TypeScript with comprehensive type definitions
 - **Input Validation**: Robust validation for all API inputs
 - **Error Handling**: Graceful error handling with informative messages
 - **Dynamic Board Selection**: Switch between boards and workspaces without restarting
+- **Markdown Formatting**: Export card data in human-readable markdown format
 
 ## Installation
 
@@ -101,6 +154,23 @@ Or if you're using mise:
 }
 ```
 
+To connect a Trello workspace, you'll need to manually retrieve a `TRELLO_TOKEN` once per workspace. After setting up your Trello Power-Up, visit the following URL:
+
+```
+https://trello.com/1/authorize?expiration=never&name=YOUR_APP_NAME&scope=read,write&response_type=token&key=YOUR_API_KEY
+```
+
+Replace:
+
+* `YOUR_APP_NAME` with a name for your application (e.g., "My Trello Integration"). This name is shown to the user on the Trello authorization screen.
+* `YOUR_API_KEY` with the API key for your Trello Power-Up
+
+This will generate the token required for integration.
+
+> [!NOTE]
+> The `expiration=never` parameter creates a token that does not expire. For enhanced security, consider using `expiration=30days` and renewing the token periodically if your setup allows for it.
+
+
 #### Don't have pnpm?
 
 The simplest way to get `pnpm` (and thus `pnpx`) is through [mise](https://mise.jdx.dev/):
@@ -246,8 +316,119 @@ This allows you to work with multiple boards and workspaces without restarting t
 }
 ```
 
+## Date Format Guidelines
+
+When working with dates in the Trello MCP server, please note the different format requirements:
+
+- **Due Date (`dueDate`)**: Accepts full ISO 8601 format with time (e.g., `2023-12-31T12:00:00Z`)
+- **Start Date (`start`)**: Accepts date only in YYYY-MM-DD format (e.g., `2025-08-05`)
+
+This distinction follows Trello's API conventions where start dates are day-based markers while due dates can include specific times.
+
 ## Available Tools
 
+### Checklist Management Tools 🆕
+
+#### get_checklist_items
+
+Get all items from a checklist by name.
+
+```typescript
+{
+  name: 'get_checklist_items',
+  arguments: {
+    name: string,        // Name of the checklist to retrieve items from
+    boardId?: string     // Optional: ID of the board (uses default if not provided)
+  }
+}
+```
+
+#### add_checklist_item
+
+Add a new item to an existing checklist.
+
+```typescript
+{
+  name: 'add_checklist_item',
+  arguments: {
+    text: string,           // Text content of the checklist item
+    checkListName: string,  // Name of the checklist to add the item to
+    boardId?: string        // Optional: ID of the board (uses default if not provided)
+  }
+}
+```
+
+#### find_checklist_items_by_description
+
+Search for checklist items containing specific text.
+
+```typescript
+{
+  name: 'find_checklist_items_by_description',
+  arguments: {
+    description: string,  // Text to search for in checklist item descriptions
+    boardId?: string      // Optional: ID of the board (uses default if not provided)
+  }
+}
+```
+
+#### get_acceptance_criteria
+
+Get all items from the "Acceptance Criteria" checklist.
+
+```typescript
+{
+  name: 'get_acceptance_criteria',
+  arguments: {
+    boardId?: string  // Optional: ID of the board (uses default if not provided)
+  }
+}
+```
+
+#### get_checklist_by_name
+
+Get a complete checklist with all items and completion percentage.
+
+```typescript
+{
+  name: 'get_checklist_by_name',
+  arguments: {
+    name: string,     // Name of the checklist to retrieve
+    boardId?: string  // Optional: ID of the board (uses default if not provided)
+  }
+}
+```
+
+**Returns:** `CheckList` object with:
+- `id`: Checklist identifier
+- `name`: Checklist name
+- `items`: Array of `CheckListItem` objects
+- `percentComplete`: Completion percentage (0-100)
+
+### get_card 🆕
+
+Get comprehensive details of a specific Trello card with human-level parity.
+
+```typescript
+{
+  name: 'get_card',
+  arguments: {
+    cardId: string,          // ID of the Trello card (short ID like 'FdhbArbK' or full ID)
+    includeMarkdown?: boolean // Return formatted markdown instead of JSON (default: false)
+  }
+}
+```
+
+**Returns:** Complete card data including:
+- ✅ Checklists with item states and assignments
+- 📎 Attachments with previews and metadata
+- 🏷️ Labels with names and colors
+- 👥 Assigned members
+- 💬 Comments and activity
+- 📊 Statistics (badges)
+- 🎨 Cover images
+- 📍 Board and list context
+
 ### get_cards_by_list_id
 
 Fetch all cards from a specific list.
@@ -301,8 +482,9 @@ Add a new card to a specified list.
     listId: string,       // ID of the list to add the card to
     name: string,         // Name of the card
     description?: string, // Optional: Description of the card
-    dueDate?: string,    // Optional: Due date (ISO 8601 format)
-    labels?: string[]    // Optional: Array of label IDs
+    dueDate?: string,     // Optional: Due date (ISO 8601 format with time)
+    start?: string,       // Optional: Start date (YYYY-MM-DD format, date only)
+    labels?: string[]     // Optional: Array of label IDs
   }
 }
 ```
@@ -319,8 +501,10 @@ Update an existing card's details.
     cardId: string,       // ID of the card to update
     name?: string,        // Optional: New name for the card
     description?: string, // Optional: New description
-    dueDate?: string,    // Optional: New due date (ISO 8601 format)
-    labels?: string[]    // Optional: New array of label IDs
+    dueDate?: string,     // Optional: New due date (ISO 8601 format with time)
+    start?: string,       // Optional: New start date (YYYY-MM-DD format, date only)
+    dueComplete?: boolean,// Optional: Mark the due date as complete (true) or incomplete (false)
+    labels?: string[]     // Optional: New array of label IDs
   }
 }
 ```

package/build/evals/evals.d.ts

@@ -1,5 +1,5 @@
 import { EvalConfig } from 'mcp-evals';
-import { EvalFunction } from "mcp-evals";
+import { EvalFunction } from 'mcp-evals';
 declare const config: EvalConfig;
 export default config;
 export declare const evals: EvalFunction[];

package/build/evals/evals.js

@@ -1,50 +1,72 @@
 //evals.ts
-import { openai } from "@ai-sdk/openai";
-import { grade } from "mcp-evals";
+import { openai } from '@ai-sdk/openai';
+import { grade } from 'mcp-evals';
 const get_cards_by_list_idEval = {
     name: 'get_cards_by_list_id Tool Evaluation',
     description: 'Evaluates the get_cards_by_list_id tool functionality',
     run: async () => {
-        const result = await grade(openai("gpt-4"), "Can you fetch all cards from the Trello list with ID abc123?");
+        const result = await grade(openai('gpt-4'), 'Can you fetch all cards from the Trello list with ID abc123?');
         return JSON.parse(result);
-    }
+    },
 };
 const get_listsEval = {
     name: 'get_lists Tool Evaluation',
     description: 'Evaluates the get_lists tool by retrieving all lists from a specified board',
     run: async () => {
-        const result = await grade(openai("gpt-4"), "Please retrieve all lists from the board with ID 12345 and provide their names.");
+        const result = await grade(openai('gpt-4'), 'Please retrieve all lists from the board with ID 12345 and provide their names.');
         return JSON.parse(result);
-    }
+    },
 };
 const get_recent_activityEvalFunction = {
     name: 'get_recent_activity Tool Evaluation',
     description: 'Evaluates the ability to fetch recent activity on the Trello board',
     run: async () => {
-        const result = await grade(openai("gpt-4"), "Fetch the recent activity on the Trello board, limit it to 5 items");
+        const result = await grade(openai('gpt-4'), 'Fetch the recent activity on the Trello board, limit it to 5 items');
         return JSON.parse(result);
-    }
+    },
 };
 const add_card_to_listEval = {
     name: 'add_card_to_listEval',
     description: 'Evaluates the add_card_to_list tool',
     run: async () => {
-        const result = await grade(openai("gpt-4"), "Please add a new card named 'Demo Card' to the list with ID 'abc123', with a description of 'This is a test card', due date '2023-12-31T12:00:00Z', and a label 'priority'.");
+        const result = await grade(openai('gpt-4'), "Please add a new card named 'Demo Card' to the list with ID 'abc123', with a description of 'This is a test card', due date '2023-12-31T12:00:00Z', start date '2025-08-05', and a label 'priority'.");
         return JSON.parse(result);
-    }
+    },
 };
 const update_card_detailsEval = {
     name: 'update_card_details Evaluation',
     description: 'Evaluates the update_card_details tool functionality',
     run: async () => {
-        const result = await grade(openai("gpt-4"), "Please update the card with ID 'abc123' to have the name 'Updated Card Name', the description 'New description for the card', a due date of '2024-01-01T10:00:00Z', and labels ['priority','review'].");
+        const result = await grade(openai('gpt-4'), "Please update the card with ID 'abc123' to have the name 'Updated Card Name', the description 'New description for the card', a due date of '2024-01-01T10:00:00Z', start date '2025-08-05', and labels ['priority','review'].");
         return JSON.parse(result);
-    }
+    },
+};
+const mark_card_completeEval = {
+    name: 'mark_card_complete Evaluation',
+    description: 'Evaluates the ability to mark a card as complete using dueComplete',
+    run: async () => {
+        const result = await grade(openai('gpt-4'), "Please mark the card with ID 'xyz789' as complete by setting dueComplete to true.");
+        return JSON.parse(result);
+    },
 };
 const config = {
-    model: openai("gpt-4"),
-    evals: [get_cards_by_list_idEval, get_listsEval, get_recent_activityEvalFunction, add_card_to_listEval, update_card_detailsEval]
+    model: openai('gpt-4'),
+    evals: [
+        get_cards_by_list_idEval,
+        get_listsEval,
+        get_recent_activityEvalFunction,
+        add_card_to_listEval,
+        update_card_detailsEval,
+        mark_card_completeEval,
+    ],
 };
 export default config;
-export const evals = [get_cards_by_list_idEval, get_listsEval, get_recent_activityEvalFunction, add_card_to_listEval, update_card_detailsEval];
+export const evals = [
+    get_cards_by_list_idEval,
+    get_listsEval,
+    get_recent_activityEvalFunction,
+    add_card_to_listEval,
+    update_card_detailsEval,
+    mark_card_completeEval,
+];
 //# sourceMappingURL=evals.js.map

package/build/evals/evals.js.map

@@ -1 +1 @@
-{"version":3,"file":"evals.js","sourceRoot":"","sources":["../../src/evals/evals.ts"],"names":[],"mappings":"AAAA,UAAU;AAGV,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAgB,MAAM,WAAW,CAAC;AAEhD,MAAM,wBAAwB,GAAiB;IAC3C,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE,uDAAuD;IACpE,GAAG,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,8DAA8D,CAAC,CAAC;QAC5G,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACJ,CAAC;AAEF,MAAM,aAAa,GAAiB;IAChC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,6EAA6E;IAC1F,GAAG,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,iFAAiF,CAAC,CAAC;QAC/H,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACJ,CAAC;AAEF,MAAM,+BAA+B,GAAiB;IAClD,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,oEAAoE;IACjF,GAAG,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,oEAAoE,CAAC,CAAC;QAClH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACJ,CAAC;AAEF,MAAM,oBAAoB,GAAiB;IACvC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,qCAAqC;IAClD,GAAG,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,6KAA6K,CAAC,CAAC;QAC3N,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACJ,CAAC;AAEF,MAAM,uBAAuB,GAAiB;IAC1C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,sDAAsD;IACnE,GAAG,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,uMAAuM,CAAC,CAAC;QACrP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,GAAe;IACvB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB,KAAK,EAAE,CAAC,wBAAwB,EAAE,aAAa,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,uBAAuB,CAAC;CACnI,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,wBAAwB,EAAE,aAAa,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"evals.js","sourceRoot":"","sources":["../../src/evals/evals.ts"],"names":[],"mappings":"AAAA,UAAU;AAGV,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAgB,MAAM,WAAW,CAAC;AAEhD,MAAM,wBAAwB,GAAiB;IAC7C,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE,uDAAuD;IACpE,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,KAAK,CACxB,MAAM,CAAC,OAAO,CAAC,EACf,8DAA8D,CAC/D,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,MAAM,aAAa,GAAiB;IAClC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,6EAA6E;IAC1F,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,KAAK,CACxB,MAAM,CAAC,OAAO,CAAC,EACf,iFAAiF,CAClF,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,MAAM,+BAA+B,GAAiB;IACpD,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,oEAAoE;IACjF,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,KAAK,CACxB,MAAM,CAAC,OAAO,CAAC,EACf,oEAAoE,CACrE,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAiB;IACzC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,qCAAqC;IAClD,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,KAAK,CACxB,MAAM,CAAC,OAAO,CAAC,EACf,sMAAsM,CACvM,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,MAAM,uBAAuB,GAAiB;IAC5C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,sDAAsD;IACnE,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,KAAK,CACxB,MAAM,CAAC,OAAO,CAAC,EACf,gOAAgO,CACjO,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,MAAM,sBAAsB,GAAiB;IAC3C,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,oEAAoE;IACjF,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,KAAK,CACxB,MAAM,CAAC,OAAO,CAAC,EACf,mFAAmF,CACpF,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,GAAe;IACzB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB,KAAK,EAAE;QACL,wBAAwB;QACxB,aAAa;QACb,+BAA+B;QAC/B,oBAAoB;QACpB,uBAAuB;QACvB,sBAAsB;KACvB;CACF,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,wBAAwB;IACxB,aAAa;IACb,+BAA+B;IAC/B,oBAAoB;IACpB,uBAAuB;IACvB,sBAAsB;CACvB,CAAC"}

package/build/get-card-implementation.d.ts

@@ -0,0 +1,122 @@
+export interface TrelloCheckItem {
+    id: string;
+    name: string;
+    state: 'complete' | 'incomplete';
+    pos: number;
+    due?: string | null;
+    dueReminder?: number | null;
+    idMember?: string | null;
+}
+export interface TrelloChecklist {
+    id: string;
+    name: string;
+    idCard: string;
+    pos: number;
+    checkItems: TrelloCheckItem[];
+}
+export interface TrelloLabelDetails {
+    id: string;
+    idBoard: string;
+    name: string;
+    color: string;
+}
+export interface TrelloComment {
+    id: string;
+    date: string;
+    data: {
+        text: string;
+        card?: {
+            id: string;
+            name: string;
+        };
+    };
+    memberCreator: {
+        id: string;
+        fullName: string;
+        username: string;
+        avatarUrl?: string;
+    };
+}
+export interface TrelloCustomField {
+    id: string;
+    name: string;
+    type: string;
+    value?: any;
+}
+export interface TrelloBadges {
+    attachmentsByType?: {
+        trello?: {
+            board: number;
+            card: number;
+        };
+    };
+    location: boolean;
+    votes: number;
+    viewingMemberVoted: boolean;
+    subscribed: boolean;
+    fogbugz: string;
+    checkItems: number;
+    checkItemsChecked: number;
+    checkItemsEarliestDue?: string | null;
+    comments: number;
+    attachments: number;
+    description: boolean;
+    due?: string | null;
+    dueComplete: boolean;
+    start?: string | null;
+}
+export interface TrelloCover {
+    idAttachment?: string | null;
+    color?: string | null;
+    idUploadedBackground?: string | null;
+    size: 'normal' | 'full';
+    brightness: 'light' | 'dark';
+    isTemplate: boolean;
+}
+export interface EnhancedTrelloCard {
+    id: string;
+    name: string;
+    desc: string;
+    descData?: {
+        emoji?: Record<string, any>;
+    };
+    due: string | null;
+    dueComplete: boolean;
+    dueReminder: number | null;
+    start: string | null;
+    idList: string;
+    idBoard: string;
+    closed: boolean;
+    url: string;
+    shortUrl: string;
+    dateLastActivity: string;
+    pos: number;
+    labels: TrelloLabelDetails[];
+    idLabels: string[];
+    attachments: TrelloAttachment[];
+    checklists: TrelloChecklist[];
+    members: TrelloMember[];
+    idMembers: string[];
+    comments: TrelloComment[];
+    customFieldItems?: TrelloCustomField[];
+    badges: TrelloBadges;
+    cover: TrelloCover;
+    list?: {
+        id: string;
+        name: string;
+    };
+    board?: {
+        id: string;
+        name: string;
+        url: string;
+    };
+}
+export declare class EnhancedTrelloClient {
+    getCard(cardId: string, includeMarkdown?: boolean): Promise<EnhancedTrelloCard | string>;
+    private formatCardAsMarkdown;
+    private formatFileSize;
+}
+export declare function validateGetCardRequest(args: Record<string, unknown>): {
+    cardId: string;
+    includeMarkdown?: boolean;
+};